Run Time Support Libraries 



None 

All Floating-Point 
in PL/M-86 only 

With Some Modules 
That Use Floating-Point 
not in PL/M-86 
An, 



Emulator or 
Actual Chip Used 



neiihe- 
emulator 



actual 6087 chip 



Neceeiarlly In tha C 
Shown) After Oblect U 



none 

E8087.LIB. PE8087 
E8087.LIB. EB087 



intfgf Development Solutions 

PL/M-86 
Pocket Reference 
for DOS Systems 



Hex-ASCII Table 



NUL 


00 


+ 


2B 




V 


56 


SOH 


01 




2C 




W 


57 


STX 


02 


— 


2D 




X 


56 


ETX 


03 




2E 




Y 


59 


EOT 


04 


/, 


2F 




Z 


5A 


ENQ 


05 





30 




I 


5B 


ACK 


06 


1 


31 




\ 


5C 


BEL 


07 


2 


32 




] 


5D 


BS 


08 


3 


33 




A(f) 


5E 


HT 


09 


4 


34 




-(-) 


5F 


LF 


OA 


5 


35 






60 


VT 


OB 


6 


36 




3 


81 


FF 


OC 


7 


37 




b 


62 


CR 


00 


8 


38 




c 


63 


SO 


0E 


9 


39 




d 


64 


SI 


OF 




3A 




e 


65 


DLE 


10 




SB 




1 


66 


DC1 (X-ON) 
DC2 (TAPE) 
0C3ftC-OFF) 
DC4 (TAPE) 


11 


< 


3C 




B 


67 


12 




3D 




66 


13 




3E 




i 


69 


14 


7 


3F 




I 


6A 


NAK 


15 


f 


40 




6B 


SYN 


16 




41 




i 


6C 


ETB 


17 


a 


42 




m 


60 


CAN 


18 


c 


43 




n 


6E 


EM 


19 


D 


44 







6F 


SUB 


1A 


E 


45 




p 


70 


ESC 


1B 


F 


48 




q 


71 


FS 


1C 


G 


47 




r 


72 


GS 


10 


H 


48 




s 


73 


BS 


1E 


1 


49 




l 


74 


US 


1F 


J 


4A 




u 


75 


SP 


20 


K 


4B 




V 


76 


I 


21 


L 


4C 




w 


77 




22 


M 


4D 




« 


78 


# 


23 


N 


4E 




¥ 


79 


1 


24 


O 


4F 




2 


7A 


% 


25 


P 


50 




< 


7B 


s 


26 


Q 


51 




1 


7C 




27 


R 


52 




) (ALT MODE) 


70 


( 


28 


S 


53 






7E 


! 


29 


T 


54 




DEL (RUB OUT) 


7F 


2A 


U 


55 
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THIS TYPE 



italics 



I ] .. 



Use these keywords, letters, symbols 
and punctuation verbatim. Upper or 
lower case is acceptable. 

Substitute language elements or 
constructs for true terms. 

Optional constructs. 

Optional constructs that can be 
repeated any number of times. 

Alternate constructs. Choose any one 
of the constructs enclosed in the 
braces. 



/* text enclosed */ Text enclosed is a prose definition of 
the construct. 

When two adjacent items must be concatenated, they 
appear with no space between them. A blank space 
between two items indicates that the two items may be 
separated by one or more blanks. 



ii 
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Compiler Invocation 

The general form of the command line used to invoke the 
compiler is: 

[directory] plm86 source [controls] <cr> 



where 

directory 

plm286 

source 

controls 

<cr> 



is the portion of the pathname that 
identifies the device and directories 
that contain the file plm86. 

is the name of the PL/M-86 
compiler. Note that it is not neces- 
sary to specify the .EXE extension. 

is the name of the file that contains 
the source. 

are the optional compiler controls, 
is a carriage return. 



Lexical Elements 



token 



numeric-constant 



binary-number 



octal number 



delimiter 

identifier 

reserved-word 

numeric-constant 

String 



/"any one of the following: 

+ -•/<>-:;.)( 
@ <><->- - 7 

n /eKer n 

letter I decimal-digit I . 
Ill U 



binary-number 

octal-number 

decimal-number 

hexadecimal-number 

floating-point-number 



binary-digit 



Tl binary-digit I "1 

Li s IJ 



octa,-d, 3 ,t[\ OC 'T l '\\ 



decimal-number 
hexadecimal-number 



floating-point number digit-string fractional-part [exponent-part] 
fractional part \digit-slnng ] 

1 E[{:}]<*o/t- S lr/n 



digit-string 
string 

stnng-body-element 
plm-text 



ndectmal-digit I ~| 
$ ij 

stnng-body-element 
| non-quote-character ) 



j-j,o*en 



comment 



I blank \ 
\ comment J 

/■{character] ... 7 



Modules and the Main Program 



compilation 
module 
module-name 

Declarations 



module I EOF I 

module-name : simple-do-block 
identifier 



declare-statement 



unfactored-element 



I declare-statement \ 
\ procedure-definition f 

I factored-element \ 
DECLARE \ unfactored-element f 



! 



factored-element 



I label-element 



I factored-variabie-element I 
factored-label-element 
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variable-element 

non-based name 
based-name 
base-specifier 
variable-attribute 



constant-attribute 
array-specilier 

variable-type 

basic-type 



label-element 



literal-elements 



j non-based-name \ [array-specilier ] 

j based-name BASED base-specifier f 
variable-type [variable-attributes ] 



variable-name-identitier 

variable-name-identilier 

identifier [. identifier ] 

I [PUBLIC] [locator) [initialization [ 1 
\ [EXTERNAL] [constant-attribute ] [ 

AT {expression ) 

DATA 

| [numeric-constant )\ 

\ n I 

I basic-type 1 
| structure type | 



INTEGER 

REAL 

POINTER 

SELECTOR 

BYTE 

WORD 

DWORD 



TIPUBLIC n 
identifier LABEL [J EXTERNAL) J 



identifier LITERALLY string 



tactored-variable-element {variable-name-specifier [, variable-name-specifier] ...) 

[explicit-dimensions | variable-type [variable-attribute I 



tactored-label-eiement 

structure-type 
member-element 
member-name 
procedure-definition 



n PUBLIC l"| 
EXTERNAL) J 

STRUCTURE {member-element [. member-element ]...) 

member-name [explicit-dimension ) basic-type 

identifier 

procedure-statment [declaration ...] [unit...] ending 



procedure-statement procedure-name : PROCEDURE [formal-parameter-list ] 
[procedure-type ] [procedure-attribute |: 



procedure-name 
procedure-type 



identifier 
basic-type 



formal-parameter-list {formal-parameter [, formal-parameter] ... ) 
formal-parameter identifier 



procedure-attributes 



interrupt 
initialization 

initial-value 



{interrupt I 
EXTERNAL! 



| interrupt \ 
\ PUBLIC 

(reentrant) 

INTERRUPT 



INITIAL 
DATA 



{initial-value [. initial-value]...) 



I expression I 
\ string ) 



Statements and Related Constructs 



unit 



basic-statement 



scoping-statement 



conditional-clause 
do-block 
basic-statement 
label-definition unit 



assignment-statement 

call-statement 

goto-statement 

null-statement 

return-statement 



I simple-do-statement 
do-case-statement 
do-wnile-statement 
iterative-do-stalement 
end-statement 
procedure-statement 



label-definition identifier : 

assignment-statement left-part - expression . 

left-part variable-reference], variable-reference]... 

call-statement CALL simple-variable [parameter-list ] : 

parameter-list {expression [. expression ]... ) 
simple-variable 



goto-statement 



j identifier I 
\ identifier . identifier \ 

(GOTO \ identifier; 
I GO TO I 



null-statement 
return-statement 

typed-return 

untyped-return 

8086-dependent- 



I [label-definition ]... do-block \ 
\ [label-detinition ]... basic-statement f 



I typed-return I 
I untyped-return f 

RETURN expression ; 

RETURN: 

{disable-statement 
enable-statement 
halt-statement 
cause-interrupt-statement 



disable-statement 

enable-statement 

halt-statement 

cause-interrupt- 
statement 

simple-do-statement 

do-case-statement 

do-while-statement 

iterative-do-statement 

index-part 

to-part 

by-part 

index-variable 

start-expression 

bound-expression 



end-statement 



DISABLE; 
ENABLE; 
HALT; 

CAUSESINTERRUPT {numeric-constant ): 
DO; 

DO CASE expression ; 

DO WHILE expression ; 

DO index-part to-part [by-part ]; 

index-variable - start-expression 

TO bound-expression 

BY step-expression 

simple-variable 

expression 



t 
i 



END [identifier |; 



procedure-statement procedure name : PROCEDURE [formal-parameter-list ] 
[procedure-type ] [procedure attributes ]; 



conditional-clause 



if condition 



i-condition true-unit 

if-condition true-element ELSE false-elemem 



{: 

IF expression THEN 



true-unit 
do-block 



simpie-do-biock 



do-while-block 
iterative-do-block 

Expressions 

primary 



Simple-do-block 
do-case-block 
do-white-block 
iterative-do-block 



simple-do-statement [declaration ]... [unit ].. ending 
t |... end statement 
it[unit[ .. ending 
do-while-statement [unit ]... ending 
iterative-do-statement [unit ] ... ending 



{constant 
variable-reference I 
location-reference 
subexpression 



subexpression 



variable-references 

data-reference 
subscript 
member-specifier 
function-reference 



member-name 



location-reference 



( expression ) 

i numeric-constant \ 
j string ] 

I data-reference \ 
\ function-reference | 

name [subscript | [member-specifier ] 

( expression ) 

.member-name [subscript | 

name [actual-parameters [ 

( expression [, expression ]... ) 



| constant-list \ 
J variable-reference j 
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constant-list 
operator 



logical-operator 



relational-operator 



arithmetic-operator 



expression 



( constant |, constant |... ) 



t logical-operator 
I relational-operator 
\ arithmetic-operator 

I AND 



(AND | 
NOT 

I xor ; 



/• any one of tne following: 

<><=>=<> = */ 

/' any one of the following 

+ - PLUS MINUS - / MOD 7 

| logical-expression \ 
\ embedded-assignment I 



embedded-assignment variable-reference : - logical-expression 
logical-expression 



I logical-factor \ 
\ logical-expression or-operator logical-factor J 



or-operator 

logical-factor 

and-operator 
logical-secondary 
not-operator 
logical-primary 

arithmetic-expression 

addtng-operator 



multiplying-operator 



jOR I 



XOR f 



logical-secondary \ 
logical-factor and-operator logical-secondary J 

AND 

|nof-operafor| logical-primary 
NOT 



arithmetic-expression [ relational-operator 

arithmetic-expression ] 

J term 

\ arithmetic-expression addmg-operator term f 



(PLUS | 
MINUS ) 



1 secondary \ 
\ term multiplying-operator secondary ] 



{mod} 



I unary-minus \ primary 
| unary-plus I 



unary-minus 
unary-plus 



Built-in Procedures and Functions 





Parameter LW 


Returned 
Value 


Operation 


ABS 


{reai-expr ) 


REAL 


Returns absolute value of 
REAL expression 


SUtLDSPTR 


(base.offset ) 


POINTER 


Returns POINTER con- 
structed with base 
SELECTOR and WORD 


CMPB 


{source 1.$ource2.count) 


WORD 


Compares two BYTE 
strings to find (irst element 
that does not match 


CMPW 


(source 1 . source2, count ) 


WORD 


Compares two WORD 
strings to find first element 
that does not match 


DOUBLE 


(byte-expr ) 
(word-expr) 
(dword-expr) 


WORD 

DWORD 

DWORD 


Converts BYTE value to 
WORD value: WORD value 
to DWORD value; DWORD 
value unchanged 


FINDB 


(source.target.count ) 


WORD 


Searches a source BYTE 
string for first element that 
matches value of target 


FINDR8 


(source.target.count) 


WORD 


Searches source BYTE 
string for last element that 
matches value of target 


FINDRW 


(source, target.count ) 


WORD 


Searches source WORD 
string for last element that 
matches value of target 


FINDW 


[source.target.count ) 


WORD 


Searches a source WORD 
string for first element that 
matches value of target 


FIX 


(real-expr) 


INTEGER 


Converts REAL value to 
INTEGER value (rounds 
toward zero) within range 
X 32767 


FLOAT 


(int-expr) 


REAL 


Converts INTEGER value 
to REAL value 


HIGH 


(byte-expr) 
(word-expr) 
(dword-expr) 


BYTE 
BYTE 
WORD 


Converts BYTE value to 
zero; WORD value to high- 
order BYTE of WORD; 
DWORD value to rugh- 
order WORD of DWORD 


IABS 


(int-expr) 


INTEGER 


Returns absolute value of 
INTEGER expression 


INPUT 


(port-number ) 


BYTE 


Returns BYTE value in 
specified input port 


INT 


(word-expr) 


INTEGER 


Converts WORD value to 
INTEGER; bit pattern is 
unchanged, but inter- 
preted as positive 


INTER RUPTSPTR 


(interrupt-proc-name ) 


POINTER 


Returns interrupt entry 
point of specified interrupt 



Built-in Procedures and Functions (Cont'd.) 



Built-in Procedures and Functions (Cont'd.) 



Identifier 


Parameter U»f 


Returned 
Value 


Operation 


IN WORD 


{port-number ) 


WORD 


Returns WORD value in 
specified input port 


LAST 


(array-vanable'raf ) 


WORD 


Returns subscript of last 
element in array 


LENGTH 


(array-vanable-ref ) 


WORD 


Returns the number of 
elements in array 


LOCKSET 


(tockptr. new-value ) 


BYTE 


Implements a simple 
software lock; returns old 
value of BYTE pointed to 
by lockptr 


LOW 


[byte-expr ) 
(word-expr) 
(dword-expr) 


BYTE 
BYTE 
WORD 


BYTE value unchanged: 
converts WORD value to 
low-order BYTE of WORD; 
converts DWORD value to 
low-order WORD of 
DWORD 


MOVB 


(source.dest.count) 


none 


Copies a BYTE string from 
one location to another 


MOVE 


(count.source.dest) 


none 


Copies a BYTE string from 
one location to another; 
provides compatibility with 
PL/M-80 


MOVRB 


(source.dest.count) 


none 


Copies a BYTE string from 
one location to another in 
descending order 


MOVRW 


(source.dest.count) 


none 


Copies a WORD string 
from one location to 
another in descending 
order 




{source.dest.count ) 


none 


Copies a WORD string 
from one location to 
another 


NIL 


none 


POINTER 


Returns POINTER value 
with all bytes set to zero 


OFFSETSOF 


{pointer ) 


WORD 


Returns offset portion of 
specified POINTER 


ROL 


(pattern.count ) 


BYTE. 
WORD or 
DWORD 


Rotates an 8-. 16-. or 32- 
bit pattern to the left 


SAL 


(pattern.count ) 


INTEGER 


Shifts the 16-bit pattern to 
the left with zero till 




{pattern.count ) 


INTEGER 


ghifts the 16-bit pattern to 
the right with sign bit fill 


SELECTORSOF 


{pointer ) 


SELECTOR 


Returns base portion of 
specified POINTER 


SETB 


{new-value.dast.count ) 


none 


Sets each element of a 
BYTE string to a single 
specified value 


SETW 


(new-value.dest.count ) 


none 


Sets each element of a 
WORD string to a single 
specified value 


SET$INTERRUPT 


{constant tnterrupt-proc-name ) 




Sets the specified interrupt 
vector to point to the 
specified interrupt 
procedure 


SHL 


{pattern.count) 


BYTE, 
WORD or 
DWORD 


Shifts an 8-. 16-. or 32-bit 
pattern to the left with zero 
till 
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Identifier 


Parameter List' 


Returned 
Value 


Operation 


SHR 


(partem, coonf) 


BYTE, 


Shifts an 8-. 16-, or 32-bit 






WORD or 


pattern to the right with 






DWORD 


zero fi>l 


SIGNED 


( work-expr ) 


INTEGER 


Converts WORD value to 








INTEGER: bit pattern is 








unchanged 


SIZE 


{variable-ret) 


WORD 


P Pt 1 1 1 n ^ the mimhor r\ f 








bvtes occuoipd hv thft 
variable 


SKIPB 


(sourcejarget.count) 


WORD 


Searches source BYTE 
















does not matsch value of 








target 


5KIPRB 


{source, target. count ) 


WORD 


Searches source BYTE 








string for last element that 








does not match value of 
target 


SKIPRW 


{source.target.count) 


WORD 


Searches source WORD 








string (or last element that 








does not match value of 








target 


SKIPW 


{ source, target, count ) 


WORD 


Searches source WORD 








string for first element that 








does not match value of 
target 


TIME 


(word-expr) 


none 


Causes a time delay of 








specified duration 




(int-expr ) 


WORD 


Converts INTEGER value 








to WORD: bit pattern is 








unchanged 


XLAT 


(source.dest.count. table ) 


none 


Translates source BYTE 








string using translation 








table to produce destina- 








tion BYTE string 



•For readability, optional Blanks nave been omitted Irom the syntax. 



iAPX 86/88 Built-in Variables 



Identifier 




FLAGS 


A WORD variable that provides access to the iAPX 86 
hardware flags register 


MEMORY 


A BYTE array of unspecified length that represents an 
uninitialized segment of the iAPX 86/88 storage 


OUTPUT 


A BYTE array of 65536 elements that represent the 
hardware output ports of the iAPX 86/88; can only be 
used on the left-hand side of an assignment 
statement 


OUTWORD 


A WORD array of 65536 elements that represent the 
hardware output ports of the iAPX 86/88; can only be 
used on the left-hand side of an assignment 
statement 


STACKBASE 


A WORD variable that represents the hardware stack 
base register (SS) of the IAPX 86/88 


STACKPTR 


A WORD variable that represents the hardware stack 
pointer register (SP) of the iAPX 86/88 
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iAPX 86/88 Built-in Functions 



identifier 


Parameter List 


velua 


Operation 


BLOCKSINPUT 


(pon,dest,count) 


none 


Reads BYTE string from 
specified input port 


BLOCKSINWORD 


[port, d&st, count ) 


none 


Reads WORD string from 
specified input port 


BLOCKSOUTPUT 


{port. source. count) 


none 


Writes BYTE string to 
specified output port 


BLOCKSOUTWORD 


(port.source.count) 


none 


Writes WORD string to 
specified output port 


CARRY 


none 


BYTE 


Returns value of hardware 
CARRY flag 


DEC 


{byte-expr > 




Performs decimal adjust 
operation on BYTE value 


PARITY 


none 


BYTE 


Returns value of hardware 
PARITY flag 


SCL 


{pattern.count ] 


BYTE or 


Rotates an 8- or 16-bit 

nattarn In tho Ittft uuith the 

panern 10 ine len wiin ine 
CARRY flag 


SCR 


Ipattem.count ) 


BYTE or 
WORD 


Rotates an 8- or 16-bit 
pattern to the right with the 
CARRY flag 


SIGN 


none 


BYTE 


Returns value of hardware 
SIGN flag 


ZERO 


none 


BYTE 


Returns value of hardware 
ZERO flag 



8087 Built-in Procedures and Functions 





Parameter List 


Raturnad 
Value 




GET$R EAL$ERROR 


none 


BYTE 


Returns contents of REAL error 
byte and clears it 


INIT$REAL$MATH$UNIT 


none 


none 


Initializes REAL math unit for 
subsequent operation 


RESTOR E$REAL$STATUS 


{save-area ) 


none 


Restores status of REAL math unit 
from the specified save area 


SAVE$REALJSTATUS 


(save-area ) 




Saves status of REAL math unit at 
the specified save area; reinitial- 
izes REAL error byte 


SET$REAL$MODE 


(mode-word ) 


none 


Sets contents of REAL stack mode 
word 



Compiler Controls 



Control 


Default 


Action 


CODE/NOCODE 

COND/NOCOND 
•DEBUG/NODEBUG 

EJECT 

IF/ELSEIF/ELSE/ENDIF 


NOCODE 

COND 
NODEBUG 

paging is automatic 

— 


Allow Of prevent listing of 
approximate assembly code 

List any text that is skipped 
Generate debug records in the 
object module 

Force start ot new page of 
printed output 

Establish actual conditional 
capability with conditions based 
on the value of switches 
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Compiler Controls (Cont'd.) 





Default 




INCLUDE, rite) 




Include other source files as 
input to the compiler 


"INTVECTOR/NOINTVECTOR 


INTVECTOR 


Create interrupt vector for each 
Interrupt procedure in the 
module 


INTERFACE 


- 


Allows PL/M to call procedures 
written in C. and vice versa 


LEFTMARGIN (n) 


LEFTMARGINO) 


Set left margin of source input 


LIST/NOLIST 


LIST 


Allow or prevent listing of 
source lines 


•MOD86/MOD186 


MOD86 


Specifies which instruction set 
the ob|ect module will generate 
for the targeted processor 


•OBJECT|(We)|/NOOBJECT 


OBJECT(source.OBJ) 


Specify a filename for the object 
module, or prevent the creation 
of an object module 


•OPTIMIZE (n| 


OPTIMIZER) 


Control the level of optimiza- 
tion performed while generat- 


OVERFLOW/NOOVERFLOW 


NOOVERFLOW 


Specify whether overflow is to 
be detected in signed arithmetic 


•PAGING/NOPAGING 


PAGING 


Format output onto pages with 
a heading that identifies the 
compiler and a page number 


•PAGELENGTH (rj) 


PAGELENGTH(60) 


Specify the maximum number 
of lines on a page 


"PAGEWIDTH (n) 


PAGEWIDTH(120) 


Specify the maximum number 
of characters on a line 


•PRINT)(We)|/NOPRINT 


PR INT( source. LST) 


Allow or prevent printed output, 
or select device or file to receive 
printed output 


-RAM/ROM 


RAH 


Direct the object-module place- 
ment of all constants 


SAVE/RESTORE 





Save certain general controls on 
the stack before an INCLUDE 
control switches the input 
source to another file 


SET/RESET {switches) 




Set switch assignment 


•SMALL/COMPACT/MEDIUM/LARGE 


SMALL 


Specify the segmentation 
scheme of a program 


SUBTITLE! subtitle | 


no subtitle 


Put a subtitle on each page of 
printed output and cause a page 


'SYMBOLS/NOSYMBOLS 


NOSYMBOLS 


List all identifiers in PL/M-86 
source program and attributes 


•TITLE('M») 


module name in 
source 


Put a title on each page of 
printed output 


•TYPE/NOTYPE 


TYPE 


Include type records in object 
module 


•XREF/NOXREF 


NOXREF 


Allow or prevent a cross- 
reference listing of source 
program identifiers 
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